Oracle iOS Integration

Integrate your project with Oracle Responsys SDK

Add PushIOManager.framework  in Linked frameworks & pushio_config_debug.json in your project as below:

Integrate your project with Bluedot Point SDK

To integrate PointSDK, please refer to the integration steps documented here

Interaction between the Responsys SDK and Bluedot Point SDK

Setup Bluedot Location Services

1. Import required header files.

import BDPointSDK
import PushIOManager

2. Implement Bluedot BDPGeoTriggeringEventDelegate:

YourClass: BDPGeoTriggeringEventDelegate { 
    func didEnterZone(_ enterEvent: GeoTriggerEvent) 
    { 
        // Your logic when the device enters a Bluedot Zone 
    } 

    func didExitZone(_ exitEvent: GeoTriggerEvent) 
    { 
        // Your logic when the device leaves a Bluedot Zone 
    } 
}

3. Assign GeoTriggeringEvent delegate with your implementation

let instanceOfYourClass = YourClass() 
BDLocationManager.instance()?.geoTriggeringEventDelegate = instanceOfYourClass

4. Authenticate with the Bluedot services

BDLocationManager.instance()?.initialize(withProjectId: projectId) { error in
     guard error == nil else {
        print("There was an error initializing the Bluedot SDK: \(error.localizedDescription)")
        return
     }
}

5. Start Oracle Responsys within the application:didFinishLaunchingWithOptions method. For a detailed setup guide, please refer to Oracle Responsys Documentation here

// Configure the SDK        
var configName = "YOUR_PRODUCTION_CONFIG_FILE_NAME.json"

#if DEBUG
configName = "YOUR_DEBUG_CONFIG_FILE_NAME.json"
#endif

PushIOManager.sharedInstance().configure(withFileName: configName, completionHandler: { (configError, response) in
    if let error = configError {
        print("Not able to configure the sdk \(error.localizedDescription)")
        return
    }
})

6. Send event to Oracle Reponsys via Bluedot didEnterZone / didExitZone callbacks.

func didEnterZone(_ enterEvent: GeoTriggerEvent) {
    let geoRegion = PIOGeoRegion(
            geofenceId: entryEvent.fenceId.uuidString,
            geofenceName: entryEvent.fenceName,
            speed: enterEvent.entryEvent?.locations[0].speed ?? 0.0,
            bearing: enterEvent.entryEvent?.locations[0].course ?? 0.0,
            source: "Bluedot Point SDK",
            zoneId: enterEvent.zoneInfo.id.uuidString,
            zoneName: enterEvent.zoneInfo.name,
            dwellTime: 0,
            extra: enterEvent.zoneInfo.customData)

    PushIOManager.sharedInstance().didEnter(region: geoRegion) { error, _ in
        if error == nil {
            print("Geofence Entry Event triggered successfully")
        } else {
            print("Unable to send Geofence Entry Event, reason: \(String(describing: error?.localizedDescription))")
        }
    }
}

func didExitZone(_ exitEvent: GeoTriggerEvent) {
    let geoRegion = PIOGeoRegion(
        geofenceId: exitEvent.fence.id,
        geofenceName: exitEvent.fence.name,
        speed: 0.0,
        bearing: 0.0,
        source: "Bluedot Point SDK",
        zoneId: exitEvent.zoneInfo.id.uuidString,
        zoneName: exitEvent.zoneInfo.name,
        dwellTime: Int(exitEvent.exitEvent?.dwellTime ?? 0),
        extra: exitEvent.zoneInfo.customData)

    PushIOManager.sharedInstance().didExit(region: geoRegion) { error, _ in
        if error == nil {
            print("Geofence Exit Event triggered successfully")
        } else {
            print("Unable to send Geofence Exit Event, reason: \(String(describing: error?.localizedDescription))")
        }
    }
}

GitHub Sample Project

A sample project which demonstrates the integration of Responsys SDK and Bluedot Point SDK is available on GitHub.